← Back to Main Page

Overview

This section describes the available REST endpoints for searching and looking up cooperative housing units (andelsboliger).

Searches return a list of results in JSON format, each containing a unique uuid.

This uuid can subsequently be used to retrieve the full summary information for the cooperative housing unit in XML format.

Endpoints

SoegningAdresse

Endpoint URL: andelsbolig/postnummervej

Method

GET

Description

Search for cooperative housing units using address information (postal code and street name). Can be searched with or without floor and door/side.

Input

Query parameters:

  • postnummer

  • vejnavn

  • husnummer (optional)

  • etage (optional)

  • sidedoer (optional)

Output

JSON response containing a list of matching cooperative housing units (incl. uuid).

Error handling

Returns standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /andelsbolig/postnummervej?postnummer=4000&vejnavn=Bj%C3%B8rneklovej&husnummer=2 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

SoegningNavnFoedselsdato

Endpoint URL: andelsbolig/personnavn

Method

GET

Description

Search for cooperative housing units using the debtor’s name and date of birth.

Input

Query parameters:

  • navn

  • fdato

Output

JSON response containing a list of matching cooperative housing units (incl. uuid).

Error handling

Returns standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /andelsbolig/personnavn?navn=John%20Doe&fdato=01.01.1970 HTTP/1.1

SoegningKommunevej

Endpoint URL: andelsbolig/kommunevej

Method

GET

Description

Search for cooperative housing units using municipality code and road code. Can be searched with or without floor and door/side.

Input

Query parameters:

  • kommunekode

  • vejkode

  • husnummer (optional)

  • etage (optional)

  • sidedoer (optional)

Output

JSON response containing a list of matching cooperative housing units (incl. uuid).

Error handling

Returns standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /andelsbolig/kommunevej?kommunekode=265&vejkode=480&husnummer=2&etage=&sidedoer= HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

SoegningCvr

Endpoint URL: andelsbolig/virksomhed/{cvr}

Method

GET

Description

Search for cooperative housing units using a CVR number (company registration number).

Input

Path parameter:

  • cvr

Output

JSON response containing a list of matching cooperative housing units (incl. uuid).

Error handling

Returns standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /andelsbolig/virksomhed/15231599 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

OpslagUUID

Endpoint URL: andelsbolig/andelsbolig/{uuid}

Method

GET

Description

Using a uuid from a previous search response, a lookup can be made to retrieve the full summary information for the cooperative housing unit. The response format can be controlled using optional query parameters.

Input

Path parameter:

  • uuid

Optional query parameters:

  • xhtml=true - returns response as XHTML

  • tmvXhtml=true - returns response as TMV XHTML

  • If neither is provided, the response is returned as OIO XML (default)

Output

XML document of type AndelSummariskHentResultat (OIO XML, XHTML, or TMV XHTML depending on parameters).

The formatting of XHTML and TMV XHTML responses is not documented in detail and may change without notice.

Error handling

Returns standard HTTP error codes, if the cooperative housing unit is not found.

Interaction pattern

Query response

Example request:

GET /andelsbolig/andelsbolig/76668740-6d7b-11df-be2b-0800200c9a67?xhtml=false&tmvxhtml=false HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*